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Volume: 2 Issue: 3 MAY? JIUNE,13933 


FROrt THE EDITOR’S DESE 
The deadline for the July/August newsletter will be August Znd,. 


The material and opinions in this Gazette are those of the individual authors and do not 
necessarily reflect the opinions of the South Bay Atari Computer Enthusiasts. The material in 
this Gazette may be copied by any other User Group providing credit is.given to the authors. 


Please address all Correspondence to} 
James A. Jengo 
SBACE 


9025 Range Horse Lane 
Rolling Hills Est., Calif, 90274 


Monthly meetings of S.B.A.C.E, are held on the 3rd Thursday of each month.at 7!00 PM at! 


HW Computers 
2301 Artesia Blvd, 
Redondo Beach,Calif, 902778 


Our esteemed officers are! 


President Gerald Bransford 
Vice President Alan Haskell 
Secretary/Treasurer James Jengo 
Librarian Harry Koons 


Newsletter Editor Sue Whitehead 


SBACE GAZETTE is in no way affiliated with ATARI, Inc. ATARI is a-trademark of Atari,Inc. 


What*s. GNU . 
by James A. Jenga 


Please don*t forget to check the Newsletter Books in the 

library every month for Newsletters sent to us (on an exchange 

basis) by other Groups! I have listed below a sampling of the 

wide variety of information available: 

~ CURRENT NOTES: a clever way to insert multiple printer 

control cades tusing Letter Perfect) using the search 
and replace command instead of manually typing in 
multiple contral codes, multiple times tby David Geller). 


How to input an aiternate character set using the NEC 
printer ¢by Jack McKirqan II). 


AD ASTRA is the bimonthly journal af the Atari Microa— 
computer Network. The Network is for ham radia operators. 
They have aver 256 members and want more. They have 
internationally attended meetings weekly! For more info: 

The Atari Microcomputer Network 

Jack McKirgan II, WDGRNG 

4749 S.R. 2e7 NE. 

Washington C.H., Ohia 43168 

(mhone: 614-869-3597) 


Peeks & Pokes thy Becky Hanneman): 
PORE i6,44ipo0ke 32774, 64 disables the BREAK 
key until change graphics mode aor Sys Reset. 


When LOADING or SAVING Rit CTRL 2 after RETURN 
and the console speaker will beep when the 
operatian is done. 


PEEK S2775 checks to see if any key is pressed 
at the time of the PEEK. The value returned is 
251 if a key is pressed, 255 if no key pressed. 


FOKE 7456,1 prints CTRL characters (like the cursor 
movement arraws) on the screen instead of per- 
forming their functions. 


PEEK S2770 returns a random integer between #-255. 
POKE 14,255 disables the keyboard. 

POKE 782,n has the effect af pressing the CAPS? 
LOWR key: n=@ for lower case, n=654 for caps, 


m=178 for CTRL characters. 


POKE 694,128 gives inverse video (@ for normal). 


—- CONTROL . 
POKE 584,1 Cold Start the system tlike turning 
the power switch off & on (by Mike Aldrich). 


~ Gig 
An interesting article on the C/65 compiler from O55. 


—-CGNTACT 
if you would like to look at the Variable table while 
in the middle of a program without saving it disk, 
type SAVE "E:" and press RETURN. The computer will 
start printing your program on the screen and it will 
start with the variable tables. If you press BREAK 
quickly, you will have the desired screen listing. 


If you press CTRL 2 the console buzzer will sound. 

Try pressing it while an operation is in progress 

(e.g. a disk copy). The keystroke will be stored in 

a buffer which will be read when the operation is aver 
causing the buzzer ta sound, waking you up ‘(by Lorraine 
Green). 


&® list of Atari modifications ta the 444/se0/318. 


POKE 8358,1446:FPOKE 839,238 cause everything ta be sent 
to a printer which would normally be printed on the 
screen. POKE 838, i128:POKE 839,246 gets back to normal. 


-KEEPING PsA. C.E. 
An article on How to use the DOS Copy function to enter 
program code into a disk file without using the BASIC 
or Assembler cartridges (e.g. if you can*t find them 
Det want to program: by Shane Rolin. 


To do a COLDSTART from DOS choose option M and enter 
address Fists ar E477 (this is just like turning the 

power off and an); for a WARMSTART (like SYS RESET) 

enter address Fite or E474 (Shane Rolin). 


An article an how ta simply install a switch on the 814 
drive to allow you to ignore write protect tape on a 
qiskette thy Hob Haden). 


An articie on interfacing the computer to the telephone 
fe.q. for dialing numbers) through the joystick parts 
(includes schematics & program) by Faul Serotta. 


—~Atari Computer Assac. of Orange County 
An article on bubble and shell sorts by Jim Budeliman. 


DOS 2.4 Binary File Load written in FORTH (Greg Beauton}). 
An article on How to add audia to a cassette program 
without erasing the program while adding the audio 
(Chuck Hosick). 

-—A Bact aU Ss 
CLIST & HUNT utilities for string searches written in 
fiag—-FORTH tby G. Smith & J. Feters). 
An article on using TY artifacting in Gr. @ ® BtKC ACE). 


Listing of JONESTRM program (by Frank C. Jones) and 
quite a few BRS phone numbers. 


A new database program FILE FAX combines mast of the 
good features of Filemanager 8404 &% Data Perfect plus 
adding a HELP function and the ability to handle large 
data bases comprising more than one diskette!!! 


A tutorial on using random numbers in ways you may 
not have thought af thy Antania Leal). 


—-KEEPING F.A.C.E. 
Directions on how to modify an “el-chep-o” transistor 
radio to work from the computer’s audia output, thus 
enabling audio with a monitor (Ed J. Reynolds WBSERE). 


A bunch of cute articles: e.g. How ta double the speed 
of the 814 by doubling the input line voltage; technical 
update on new Erase OGniy Memory; the Black Hole Diode. 


The BYLAWS of Pittsburgh ACE, Inc. 


-ATARI COMPUTER ASSOC. OF ORANGE COUNTY 
Some useful XIG (DOS) commands (by Josh Fine): 


RENAME X10 32,#1,4,8,"D: TEMP. CAROL” 
DELETE X10 33,#1,4,4,"D: TEMP. BAS” 
LOCK FILE X10 35,#1,8,4,"D: TEMP. BAS" 
UNLOCK FILE X10 36,#1,4,4, "D: TEMP. BAS" 
FORMAT DISK X10 254,#1,4,8, "Dizi" 


—-PAGE & 
A program ta create text windows on Gr. 97,14 or ii screens 


—-ATARI COMPUTER CLUB OF OKC, INC. 
An article thy Andee White) an binary & hex number systems 


The Macrotronics Atari Screen Printer Interface (a review) 


by 
James A. Jenga 


If you do much (or even not so much) graphics work s you have 
probably wished you could print the screen display on your 
printer. In fact, I’m sure many of you have with programs such 
as the one by Computer Age Software (which works very nicely, 
by the way, But with one exception). A problem arises however 
if you have a screen display comprised of a non-standard 
display list {1.e. not a version of Graphics Modes #-&). 
Certain commercial programs and af course many custom—made 
pragrams will use "home-made" display lists toa intermix text 
and graphics in effective and novel ways. Unfortunately; the 
otherwise very effective program by Computer Age Software wiil 
not allow "dumping" (what a horrible sounding word!) displays 
from custom display lists. 


Fortunately, the Macrotronics Atari Screen Printer Interface 
solves this problem, and in a GRAND way. It not anly will 
print out ANY type of display ‘with standard or custom display 

(wy lists), but also will print out any Player/Missle Graphics 
characters that happen to be on the screen (if you wish), and 
$¥< alli that wasn’t enough, it does all this WITHOUT the a5 
Interface Module!!! 


Macrotronics supplies along ribbon cable with a combination 
double yoystick oplug/intertface board which simpiy and 
unobtrusively plugs into joystick ports 324, with the ather 
end plugging into your printer (specify type: Centronics 73%, 
Trendcam 21%, IDS 4486 or 4456, Ensan MX74@, MXR@ or MAIGS 
(with Graphtrax Flus), Gkidata (with Gkigraph) or NEC S#@258A). 


The documentation is well written, thorough and easy ta 
understand with multiple examples. and, most importantiy, it 
@all works like it says it*s supposed to! One simply boots up 
the system with the supplied autoboaot disk tit doesn’t matter 
if a cartridge is in place since this works under cartridge ar 
machine control): enter the type of printer you have (numeric 
choiceis remove the disk and go an with whatever you wanted to 
do. When you want to "dumo”"” the screen you just press CTRL FPF 
end your program will ston executing, the screen dump will 
accur, and then your ariginal program will cantinue oan. 
Ailternatively, one may Start the print-aut under program 
control using a USF statement in BASIC tor a JSR in ASSEMBLY). 


Multiple optians are available. The aspect ratio can easily be 
changed allowing either changes in the harizontal and /ar 
vertical scaling. Additiaqnally, one can reverse the colors ta 
get white characters an a Black background. Also, if the gray 
scale representation of the screen*s colors is not pleasing, 
you don’t have to change the camputer*s color registers; 
instead, you can specify that the "Screen FPrinter’s" calar 
registers be usec: these can he changed without altering the 
computer proagram/display in any way. You also have the option 
to fave your print-oaut scaled either according to the hue GOR 


the iluminance of either the commuter’ s or the "Screen 
Printer’ s" color registers. Qne can also print data which has 
heen "fine scrolled." In order toa print player/missile 


displays, one need aniy specify the address of PMBASE. 


While this program is loaded (it aniy requires 217& bytes arf 
memory) . normal programming and execution may be done, 
ancluding listing data to the printer with the usual LFRINT or 
i_LTST commands, even though the 856 Interface i5 not connected. 
Aisa suppiied is an autahooting printer driver program you can 
lead Cin very littie memory) if you don*t want screen dump 
ability But do want the ability to print data without Raving 


& 


tio reconnect the 854 Interface. 


In Summary, Macrotronics Ras done a FANTASTIC job in making § an 
extremely versatiie, easy to use and well documented screen 
wy printing program. tt will work with or without a running 
program, display fine scrolied data, display player/missile 
graphics and, of course, any custom display list you can 
concact. On top of that it allows printing data to the printer 
f2®.qg. program listings) without use of the 85@ Interface. And 
what*s even better ais the very reasonable price af this 
hardware/saftware package. fF recommend i€ Aighiyv! 


* Oe OK 
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What’s GNU (Chanter 2) 


We Will have a demo disk of 3 programs from London Software, 
including TRION. They have offered our Group a substantial (!') 
discount on Group orders of 25 aor more pieces. Be sure to be 
at the dune meeting. 


From LAACE (3/83): G.A-M.E.5. will give a 248% discount off 
retail price oan all software for the Atari computer if you 
present a valid Club membershin card (local store: 28i4 Ww. 
Sepulveda, Torrance)!!! 


From ACE CEugene, Ore.) (6/85): 

- rumors on the new line of computers & peripherals (M. Benioff) 

- new software for PCS line from Atari: Pole Position, Joust, 
Tempest, Battlezane, Fengo, Moon Patrol, Fangaroaa, Robotron, 
Jungle Hunt, Vanguard, Microsoft Basic 2, DOS 3.4, Dig Dua, 
Assembler Editor =, New Hasic, Eastern Front (ROM), Donkey 
Kong, Tennis, Logo, Ms. PacMan, Superman 3, Music System 1+2, 
Liberator. (M. Beniaftf) 

—- Regular monthly sectians on PILOT and ASSEMBLY 


Fram LAACE (46/8353: 
— Atari BASIC Reference Manual Update (from Atari) 
~- Review of Data Perfect (Ray Maynard) 


From ACADC (5/83): 

—- Full-View &@ review (Russell Kavanagh) 

—~ Descrintion of the NCT 818 Turba modification for the 818 
drive canverting it to double density, as demo’d at our 
last meeting 

From ACE (Eugene, Ore. 3 €i/33): 
— article on Burst 1/0 by Pat Warnshuis 


From Huntsville Atari Users Group (5/85): 
— Human Engineering in Personal Computers by David Hayes 
~ Review of Atari Writer word processor cartridge (by Mike 
Dunn of ACE of Eugene, Oregon) 


From ACE (Eugene, Ore.) (9/82): 
~ Review of Full—-View 84 by David Stellmack of ACE of Columbus 
From CIO (3/83): 
—-‘Tape Loading FProgram to help find the correct counter # 
on the cassette recorder by Dan Chun 
— Many “disk errors (144 & 173) may be avoided by making 
sure your 814 is powered by a power supply with a "S36 VA" 
rating, aS opposed to the “15.3 VA" rating of the computer’s 
Attn: Ham Radio Qnerators (& all Atari users): we now are 
receiving Ad Astra, The Atari Microcomputer Network run by 
Jack McKirgan II ‘wWwDSRNG). 
From Keeping PACE (3/83): 
—~ a review of Bank Street Writer by Rick Gierl 
— Program Overlays with Atari Basic by Steve Monn of the 
Frederick Atari Computer Technical Society 
From Current Notes (3/83): 
—~ article on layout of memory in the computer 
From ACE (Eugene, Ore.) (3/83): 
—~ review of the ATRAG@@ Interface by Pat Warnshuis of 
Portland ACE, who also reviewed the Monarch and Data-— 
soft Basic Compilers 
— a very positive review of DISKWI2Z written by our own 
Jerry Allen (congrats!) 
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of a gingle Ram Select board and two Atari 16K boards. Modification far a 
Leck configuration would be fairly trivial. The 194k canfiguratian would 

require use of 256 byte “sectors” and additional FMS CHANGES . The meme y 

Greiveé i& accessed aa De:., The device number is simple ta change. 


enable the memory digk is at the same location, 3 It assumes a canfiguratian ~ 


There is aleo a bug in O8/A+ version 1.2 that must be fixed to avoid Losin Cj 
the memary drive when system reset is hit, The problem is that C5 /A+ et eapy ss cH 
DOSINI whenever it is entered through CPALOC (€O08/A+ owners will know what I 
Falking about.) The f#Olloawing Geen es may be applied ta version 1.2 to 
correct the problem. Make the patches and write a new DOS. SYS file befare 
loading the memory disk Nandler. The patches are made useing the 
assembler /editor or EASMD debugger. The problem has been fixed in 
mt Ces Oe, 
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LG41 o<— LDR 
L642 — Se #e> 

The memory drive pragram consists of two parts, an initialization 

routing that 18 used ance and then goes away, and the “memary 

Nandler”’ that 2.6 kept in memory. The initialization routine 

“formate” the memory disk (i.e. -Feates a directory. and. Vi. 

Links the memory handler inte te DOSINT chain, relocates the menor y 
handler to the current location in MEMLO, makes the necessary patch 

to FRG to enable the memory disk and then @xits through (46 menor —_— ~ 
handler’ «¢ DOSINYE routine to set MENLO to a mew Value above tbhrie 
mammary handler, The memory handler intercepts all FMS calls to the 
OS Ratt s biti srautite. lt the call is for the memory dick then bres 
La ls traneterred ta ar fram the bank memory rather than calling 
2m if the call is not far the memory digck then S10 is called. 


The drive ueced as the memory drive (Ditt in this cate) must be 
Corr 2 uur ec im the DOS a that FHM initialization will alloca 
drive butter. My OS/Aa+t release digk already Nad drive Dit: 
sent paces, The procedure far canfiduring drives may be foaune in 
either the OS/A+ reference manual ar the DOS LT] reterence manual. 
The device mumber of the memory drive may be changed by changing the 


peo oS 


Value of MDEV in the memory drive program. The corresponding cevi ce 
must then be canfigured in DOS. The mumber of memory banks 

BLIp ported may be changed by changing the value of BANE S im the 
manor y Geive pragre am. Ary mumber of banks fram ie to 2S may he 
supported. 


os “ee. > Sap e. 2. waee 


The memory drive is installed on OS7A+ by assembling it to a tile 
meilled MDRIVE.COM and then incanting "MDRIVE” at the Dis prampt. at 
fay be made the default drive hy incanting "Dea", MDRIVE may he 
weed dn congunmection with the MoS SS handler although the system rese 
fix described by Bill Wilkinson in COMPUTE! should be applied to 
RSS ecetlb.. Im ract, it if permigsgable toa use the memory drive while 
an Ro&SS2 port 16 open in cancurrent T/0 mode. MDR IVE may be loacect 
either beftaore or after the RoE2ALS handler. 
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EPSON MX-80 AND THE ATARI WORD PROCESSOR 


by A.Koudounaris (Phone 213 374-4871) 


I purchased the Atari word processor (Version 1.0) and the 
Epson printer(MxX-80 FT with Graftrax plus) at the same time. 
learning the word processor took me awhile since I was entirely 
unfamiliar with word processing in general. As to the Epson, the 


book of instructions is excellent, however, it can be somewhat 


frustrating when it comes to applying it to the word processor. 
After considerable experimentation I prepared a table “(for my 
convenience that I believe will help those of you who have the same 
hardware and software. I keep a copy of this table handy when I am 
typing. 3 

The surest way to get the Epson to do what you want it to do is 
to feed it string characters (CHR#$(123)), but they are a pain to 
types besides, the word processor will not allow you to enter 
strings. Control and escape characters are more convenient to use 


and they will work. : 
The table below shows some of the most useful functions that 
the Epson can print. One column shows how to get those functions 


using Basic or direct mode. In this case you use the LPRINT or 
PRINT"P: instruction and type quotation marks to enclose the special 
characters. The ESCAPE key is pressed twice. For the word processor, 
insertion of the characters is done while in the Edit mode by typing 
CONTROL INSERT then entering one special charactersif a seécond 
special character is required then CONTROL INSERT must be entered 
again. A special character example is ESCAPE G, in this case the 
ESCAPE key is pressed once only. 

Note that in some cases using lower case letters in an 
instruction will not work. That is why in the Table the word CAPS is 
used. 

Two recent articles have appeared on this subject and may be of 
help alsos one is in Analog, issue number 10,p.61 "Epson Printing 
Modes Simplified". The other is in Compute!,April ’*83 “Using the 
Atari Word Processor with an Epson Printer",p.157. 


age aaa SFECITALE CHARACTER FUNCTIONS 


— ss ge a A YO RS ST SN SS SE SY SOE GT NS GES WE ene eS me ae ene Gn Sree mn GES Sum ome eee Gen mem cee Gam ee eee eee ee eee cme ee eee ee ee ee ee ee wee eee ee ee wee ee ee ee ee ee ee ee ee ee oe 


: FUNCTION | ON7} BASIC OR DIRECT MODE : WORD FROCESSOR | 
: OFF! |. SEePTRL/SINGERT ° ~ 
(5 Cee = Cie eee TC] SE8C.— -CirCrRese } 
| UNDERLINED! ; 
' OFF} “ESC/ESC - CTRL/," " ; CTREFs 1 
| OGRE. tf ON: t= ABBE JESC Ge ee et ee SieEse. Gos. 
' STRIKE ; (CAPS) } 
' (Bold) ' OFF: “ESC/ESC H" CI:ESC.H ; 
St Se en fe eee Ba. Aer ee ee Slieseee = 
‘EMPHASIZED : (CAFS) } 
; OF: “ESC/ESC F" Cr: ESE.F “4 
See ae 8 Ss ae a ee, ey Cee es are SiseSC f° 
. “snes. 4 

: OFF! “ESC/ESC 5" CI:ESC.5 

4 

‘Pernt tiene oN CNTR NS 3 3 ae a. ee 
‘wIDTH : 

+ LONE FRE Not required Not required 


—_——_——— EE eR EE ES CR CE Ge SEE GRee, CE GE Gee: GS See: GEES GEEee GEE aoeer Geen Geer cEEue GUE cEES ame exe come cee cee eee eee: Gee eee eee Ge cee eee SE eee ee eee Gee eee ee ee ee ee ee ey eee eens eee cee ee ee ee 


DOUUERLE ON : “ESC ESC W CTRL A” 
WTDpDTH I: } 


(+ CONTINUOUS: OFF "Sew teo. Ww CTRL, 

: MASTERS SCORE RP: =" “8807 ESC Otto ee Sipe e+Ciresc,¢-— “ 
+ RESET : H i 
‘SUBSCRIPTS |°ON } © ESC/ESC S CTRLVA" 4CI:ESC,S CIICTRL/A. 
detec a eM ON ; pec: 4 CTRL /.” a oe 5 Oe 

+ oJ /SUPERSC i -OFrF.| reeC/E ou -1 © Hg EE ha) eS 
‘NOTE:Leaves printer in double strike mode-use master reset to delete 


—_— ee Se Se EE See GE Ge Gee CEE Gee CE COE GEE GEE GEE GEES em GEES SEED CEST GEE. GEE SSE Gee Gee CEEtS GEE Ge Gee cee Gee GE Gee Ge Cee GE Gee ee ee ee ee ee ee ee eS oe ee a ae 


oN "CTRL 7G" P CTS{ATARTICIRE 7G. 
‘COMPRESSED ! : ! : 
! OFF} "CTRL/R" CI:CTRL/R : 
P BUZZER 2) 00N {= -4ESP7ESC CTRL 7G 22 — i Gl beu. ee erRL /G- ? 


A A SE A I A A A A A SS A A LS A A SET EERE SEE EN SY SN! CE SE EE SS SE SY SE GE ES EG RE EE ES SY Se Se SE SE Se aE ee 


Notes on getting comprescsed characters with the word processor. 


To start printing compressed characters you must use (Atari)cantrol 
GOs either capital or lower case . The catch is that you have to write 
this entry on the line preceding the one you want to have compressed. 
To end compressed characters you have to enter control F (for r). 
Use of 19 or 16 cpi does mot have any effect. 

Example: 

TI will place. the Atari ctrl O here “X" 

This writing i¢ all compressed.When | as finished with coapressed, | 

will then enter the contro] R,here °*X" Which then brings me back to a) 
normal. 
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Game Review By William Cagle 


Hear Ye, Hear Ye, all who would go forth and due battle 
for the Dragon’s Eye. Thou wilt need an Atari 400/800 computer 
with a memory of 40K and the Basic cartridge. 


To begin, thou will be asked thy name, then thou shall be 
asked to pick a title and the weapon thou shall use. At this 
point thou shall be given a scroll of spells to use during the 
adventure. This entire adventure shall be controlled by the 
use of the Keyboard. 


Now the quest begins. There is a time limit of twentyone 
(21) days by the game calandar so watch it. You are ina part 
of a province called the Fel City. Remember well where you 
start so you may return there at the end of the quest. In all 
there are six (&) other provinces in the Kingdom and somehow 
you must find the Eye in one of them. The other provinces are 
the Lofty Mountains, the East Plain, the Deep Chasm, Ley Land, 
the West Plain, and the Dark Forest. Use well your spells and 
weapons, for there are many monsters to be fought, from bats to 
dragons. There are also many treasures to be found alang with 
the Eye. 


I myself donot do well with adventure games, but this one 
by EPYX was different. It*s graphics and sound were very good 
and I could keep track of what I was doing. So on the Cagle 
scale of games I give this one a 7+. 


Try this game, I think you’l] be pleasentlily surprised. 


2" FORTH & BACE " 
By D.J. Whitehead 


Well, here we are again, it is time for me to set down at the TSO ( for you 
forthers, => 
+ TSO ." Two Seater Outhouse " ; ) 
This issue I am hitting the high points of FORTH and Atari Graphics. Those of you 
who attended the FEB. SBACE meeting followed by the Forth users get together will 
recall a challenge to improve a simple graphics screen. This set of two screens, 
along with a simple set of explanations will make up this issue’s column. 


SCR # 20 
0 (GRAPHICS EXT-&/8Z SCR 50 REQ’D) 
1 (88 @ -> SCREEN 0,0 LOCATION ) 
2(88 @1+C@-> 1,0 SCR CONTS) 
3 
4;R/WSCR 1 +0 DO 88 @I 128 * + ( ADDR) 
~ I PAD 2+ @+ PAD @( ADDR Bt F-) 
& 1 SWAP -DISK DROP DROP LOOP } 
7+ GSCR 5 GR 25 R/WSCR ; 
@:STO 600 PAD 2+ !0 PAD !}; 
93 RCL 600 PAD Z+!1PAD'; 


SCR # Zi 
0 ( JOYSTICK DRAWING REQ’ SCR 20) 
1 1 VARIABLE CURS 
2 40 VARIABLE GX 20 VARIABLE GY 
30 VARIABLE DGX 0 VARIABLE DGY 
4;GLOC 00 DGX ! DGY ! 632 C@ 
2 DUPS8 AND O= IF i DGX ! ENDIF 
& DUP 4 AND 0= IF -1 DGX ! ENDIF 
7 DUP2 AND O= IF 1 DGY ! ENDIF 
8 DUP 1 AND 0O=IF -1 DGY ! ENDIF 
? DROP ; 
10} GTRI 644 C@ 0= IF 0 CURS ! 
11 ELSE 1 CURS ' ENDIF ; 
12 $GLIM GX @ DGX @+ 0 MAX 79 MIN GX ! 
i3 GY @DGY @+0 MAX 79 MIN GY !; 
14; DRW 3 GR BEGIN GLOC GTRI GLIM CURS @ 
15 GX @ GY @ PLOT ?7TERMINAL UNTIL ; 


The above screens require that screen 50 from the SHACE fig FORTH 1.15 is loaded. 
This can be performed by 

30 LOAD “<cr> 
Then load the above screen Z0 followed by screen Z1. A brief explanation of each of 
the words in screen ZO, and 21 follows.. 


The first three lines of scr Z0 are comments. Note line 0 of any screen will be 
displayed by the use of the FORTH command index. Lines Z and 3 are reminders 
that loc 88 decimal contains the address of the CRT . Therefore by looking at the 
CONTENTS of memory location 88 base ten, you can see what is at x=1,y=1 on the 
screen. ( Note in forth x=1 is i x! for a 16 bit word, or 1 x c! for a & bit word.) Scr 
20 is used for the storage and recall of the graphics image. The user is only 
interested in three words defined on this screen. these are « 

GSCR -> used to specify a Graphic SCReen command 
STO -> specify a STOrage function 
RCL -> specify a ReCaLl function 
( Yes, I am from the HP calculator school thus STO and RCL words are used a lot,) 


The proper syntex 15 ee 
RCL GSCR (-> displays the graphics information stored at disk block 600 to 
&Z5e) 
STO GSCR (-> saves the graphics information at disk blocks 400 to 625.) 


The word R/WGSCR is the actual commands to operate the disk drive. (It 
should be pointed out that a graphics 5 screen does not require all Z5 disk blocks. I 
am leaving it to the readers to find out the smallest number of disk blocks to use,) 
Note by separating then out, STO and RCL become simple words to define. 


Lets examine screen 21 in detail. First line 0 is a comment for INDEX to 
pickup. Note that screen ZO is indicated as required. This is in part due to my having 
generated a neat picture for my son, using just screen Z1, and then being unable to 
save it!!! Thus for your own sanity it is best to have at least a crude methad of 
Saving your work available. Note lines 1 to 3 define 5 variables in FORTH. For 
example, 1 variable curs in FORTH is equivalent to writing curs =1 in basic. In 
general CURS is the curser state ( 1-> on/ 0O-> off). GX and GY are the Graphics X 
and Y location of the curser, while DGX and DGY are the Delta, or offset from the 
current GX and GY which the user has commanded by pushing the joystick. Review 
of SCR Z1 shows the default ( starting ) values for the X and Y location to be 40 and 
ZO units. This is about the center of a graphics = Atari screen. The word GLOC is 
defined to read the joystick ( pluged into port 0 ) and determine the correct values 
for DGX and DGY,. The first thing GLOC does is to zero out any prior values in DGX 
and DGY. This is accomplished by placing zero on the stack twice, then storing the 
top of the stack first in DGX by the ! word, then in DGY. For simplicity both DGX 
and DGY are considered as 16 bit words. However, when memory location 632 
decimal is examined, it must be considered as a BYTE (8 bits). This is accomplished 
by using the word C@ instead of just the word @.For those of you who know the 
Atari memory map, location 63Z is well known as the O port joystick location. If the 
joystick was pushed to the right, the most significant bit (MSB) bit 7 will be set to 
ai. When the stick is pushed to the left, then bit &6is set to ail, (If both bits 7 and 
6 are set, then you have a bad joystick; or you have been playing too much Star 
Raiders.) By noting that if bit 0 is set the resulting value of the byte is 1, while bit 
i set is a Z, bit 3 set yields a 4,and finally if bit 4 is set an & results, allows a 
simple method to check the joy stick direction. remember to keep track of the stack 
during this process. In this case I am duplicating the top of the stack prior to each 
‘AND’ command, Thus at the conclusion of the command word GLOC I must clear the 
STACK by using the ‘DROP’ word in line 9, 

Line 10 contains the definition of the word ‘GTRI’,. For those of you who use basic 
peek, and poke, location 644 will be remembered as the location of joystick 0 trigger 
status. Upon examination of line 10, note I am placing the contents of the trigger 
byte on top of the stack. The top of the stack is then checked to see if it is or is not 
zero, by using the ‘O=’ word. The remainder of line 10 and all of line 11 is used to 


Place a 0 in curs if the trigger button was pressed, or else a value of 1 is assigned 
to the variable curs. 

Lines 12 and 13 define a word called ‘GLIM’, which is used to define the limits of 
the graphics area. This word also adds in the offset or movement which the user 
wanted when he ( or she ) pressed the joystick. Because this word performs two 
functions, lets look at it in some detail. In order to make this a little clearer, and to 
show a method I use when generating new words, lets write the word vertically and 
place comments beside it, 

: start of a colon definition 
GLIM name of definition ( Graphics LIMit ) 
GX address of where graphics curser is in the x direction 
(a place x value on stack 
DGX address of where the delta x desired is stored 
(a place delta x value on stack 
+ add the top two items on the stack, placing the result on top. 
0 place zero on top of the stack 
MAX compare the top two values of the stack, and keep the larger one. 
79 ~=place 7% on top of the stack 
MIN keep the smaller of the top two values of the stack 
GX the address of the ( now updated) X position, 


; store the second value of the stack, at the address found at the top of the 
stack 


etc for the y dimension in line 13 


; close out colon definition 


: start of colon definition 
DRW name of definition for DRaWing on the screen 
2 place the value 5 on the stack 


GR the FORTH command ,taking the top number of the stack 
and using it like the basic graphics command GR. 
BEGIN the start of a loop 
GLOC find out where user wants the curser 
GTRI does user want the curser on or off? 
GLIM besure the curser stays on the screen 
CURS @ place status of curser on stack 
GX @ place x location on stack 
GX @ place y location on stack 
PLOT similar to BASIC, however a third value used is the color register 
?TERMINAL if a key on keyboard has been pressed, leave a TRUE flag on stack 
else leave a false flag on the stack 
UNTIL _ pick up flag from stack, if false 
loop back to begin; else fall out of loop 
; terminate colon definition 


This concludes the explanation of the screens 20 and 21. To use then just load 
screens and type DRW. Then use a joystick (in port 0) and try your hand at drawing. 
When you are finished, press any key, and type STO GSCR to save it. remember the 
challenge still stands, generate improvements to these screens, and I will place 
them in the column, with YOUR byline. 


I'M JONN 


Editorialette 
by James A. Jenga 


Dear Software Publisher =: 


Please don’t announce release dates for upcoming programs and 
software packages 1f you can’t produce! This seems to be cammoan 
practice, and is very annoying to us proegram users. I quess you 
want to get us ali excited about your product so we’il want ta 
‘dash out and buy it as soon as it 15 released, but what happens 
is that we quickly get disgusted with all the delays in release 
and frequentiy will Buy a reasonable substitute when it hecomes 
available. Several campanies already Nave a reputation for this 
practice. Flilease have a little more consideration for us. 

Thank you. 


Among ather articies and cammentaries the next issue will have 
a review of the new Monkey Wrench II by Eastern House Software 
€F jyust received my upgrade yesterday). 


Please continue ta submit articles, programs and reviews. 


Congrats to Robert Smith on his new position! 


Ss. B. A.C. E. 


5025 Range Horse Lane 
Rolling Hills Est., CA 90274 


